package com.whfc.common.third.mas;

import com.whfc.common.exception.BizException;
import com.whfc.common.third.mas.entity.ProjectInfoListResponse;
import com.whfc.common.third.mas.entity.ProjectDetailResponse;
import com.whfc.common.third.mas.entity.MeasurePointListResponse;

/**
 * MAS系统项目信息API接口
 */
public interface MasProjectApi {

    /**
     * 条件查询项目信息
     * 
     * @param saToken 用户令牌
     * @param name    项目名称（可选）
     * @return 项目信息列表响应
     * @throws BizException 业务异常
     */
    ProjectInfoListResponse listProjectInfo(String saToken, String name) throws BizException;

    /**
     * 查询测点名册列表
     * 
     * @param saToken   用户令牌
     * @param projectId 项目ID
     * @return 测点名册列表响应
     * @throws BizException 业务异常
     */
    MeasurePointListResponse listMeasurePoints(String saToken, Integer projectId) throws BizException;

    /**
     * 根据ID查询项目详情
     * 
     * @param saToken   用户令牌
     * @param projectId 项目ID
     * @return 项目详情响应
     * @throws BizException 业务异常
     */
    ProjectDetailResponse getProjectDetail(String saToken, Integer projectId) throws BizException;
}